home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / DJGPP / DJDEV111.ZIP / include / dpmi.h < prev    next >
C/C++ Source or Header  |  1993-10-16  |  5KB  |  137 lines
  1. /* This is file dpmi.h */
  2. /*
  3. ** Copyright (C) 1993 DJ Delorie, 24 Kirsten Ave, Rochester NH 03867-2954
  4. **
  5. ** This file is distributed under the terms listed in the document
  6. ** "copying.dj", available from DJ Delorie at the address above.
  7. ** A copy of "copying.dj" should accompany this file; if not, a copy
  8. ** should be available from where this file was obtained.  This file
  9. ** may not be distributed without a verbatim copy of "copying.dj".
  10. **
  11. ** This file is distributed WITHOUT ANY WARRANTY; without even the implied
  12. ** warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  13. */
  14.  
  15. #include <sys/types.h>
  16.  
  17. typedef union {
  18.   struct {
  19.     u_long edi;
  20.     u_long esi;
  21.     u_long ebp;
  22.     u_long res;
  23.     u_long ebx;
  24.     u_long edx;
  25.     u_long ecx;
  26.     u_long eax;
  27.   } d;
  28.   struct {
  29.     u_short di, di_hi;
  30.     u_short si, si_hi;
  31.     u_short bp, bp_hi;
  32.     u_short res, res_hi;
  33.     u_short bx, bx_hi;
  34.     u_short dx, dx_hi;
  35.     u_short cx, cx_hi;
  36.     u_short ax, ax_hi;
  37.     u_short flags;
  38.     u_short es;
  39.     u_short ds;
  40.     u_short fs;
  41.     u_short gs;
  42.     u_short ip;
  43.     u_short cs;
  44.     u_short sp;
  45.     u_short ss;
  46.   } x;
  47.   struct {
  48.     u_char edi[4];
  49.     u_char esi[4];
  50.     u_char ebp[4];
  51.     u_char res[4];
  52.     u_char bl, bh, ebx_b2, ebx_b3;
  53.     u_char dl, dh, edx_b2, edx_b3;
  54.     u_char cl, ch, ecx_b2, ecx_b3;
  55.     u_char al, ah, eax_b2, eax_b3;
  56.   } h;
  57. } _go32_dpmi_registers;
  58.  
  59. typedef struct {
  60.   u_long  size;
  61.   u_long  pm_offset;
  62.   u_short pm_selector;
  63.   u_short rm_offset;
  64.   u_short rm_segment;
  65. } _go32_dpmi_seginfo;
  66.  
  67. typedef struct {
  68.   u_long available_memory;
  69.   u_long available_pages;
  70.   u_long available_lockable_pages;
  71.   u_long linear_space;
  72.   u_long unlocked_pages;
  73.   u_long available_physical_pages;
  74.   u_long total_physical_pages;
  75.   u_long free_linear_space;
  76.   u_long max_pages_in_paging_file;
  77.   u_long reserved[3];
  78. } _go32_dpmi_meminfo;
  79.  
  80. /* returns zero if success, else dpmi error and info->size is max size */
  81. int _go32_dpmi_allocate_dos_memory(_go32_dpmi_seginfo *info);
  82.     /* set size to bytes/16, call, use rm_segment.  Do not
  83.        change anthing but size until the memory is freed.
  84.        If error, max size is returned in size as bytes/16. */
  85. int _go32_dpmi_free_dos_memory(_go32_dpmi_seginfo *info);
  86.     /* set new size to bytes/16, call.  If error, max size
  87.        is returned in size as bytes/16 */
  88. int _go32_dpmi_resize_dos_memory(_go32_dpmi_seginfo *info);
  89.     /* uses pm_selector to free memory */
  90.  
  91. /* These both use the rm_segment:rm_offset fields only */
  92. int _go32_dpmi_get_real_mode_interrupt_vector(int vector, _go32_dpmi_seginfo *info);
  93. int _go32_dpmi_set_real_mode_interrupt_vector(int vector, _go32_dpmi_seginfo *info);
  94.  
  95. /* These do NOT wrap the function in pm_offset in an iret handler.
  96.    You must provide an assembler interface yourself, or alloc one below.
  97.    You may NOT longjmp out of an interrupt handler. */
  98. int _go32_dpmi_get_protected_mode_interrupt_vector(int vector, _go32_dpmi_seginfo *info);
  99.     /* puts vector in pm_selector:pm_offset. */
  100. int _go32_dpmi_set_protected_mode_interrupt_vector(int vector, _go32_dpmi_seginfo *info);
  101.     /* sets vector from pm_offset and pm_selector */
  102. int _go32_dpmi_chain_protected_mode_interrupt_vector(int vector, _go32_dpmi_seginfo *info);
  103.     /* sets up wrapper that calls function in pm_offset, chaining to old
  104.        handler when it returns */
  105.  
  106. /* These can be used to generate assember IRET-style wrappers for functions */
  107. int _go32_dpmi_allocate_iret_wrapper(_go32_dpmi_seginfo *info);
  108.     /* Put function ptr in pm_offset, call, returns wrapper entry in pm_offset. */
  109. int _go32_dpmi_free_iret_wrapper(_go32_dpmi_seginfo *info);
  110.     /* assumes pm_offset points to wrapper, frees it */
  111.  
  112. /* simulate real mode calls.  CS:IP from regs for non-interrupt */
  113. int _go32_dpmi_simulate_int(int vector, _go32_dpmi_registers *regs);
  114. int _go32_dpmi_simulate_fcall(_go32_dpmi_registers *regs);
  115. int _go32_dpmi_simulate_fcall_iret(_go32_dpmi_registers *regs);
  116.  
  117. /* These automatically handle the tasks of restructuring the
  118.    real-mode stack for the proper return type.  The callback
  119.    (info->pm_offset) is called as (*pmcb)(_go32_dpmi_registers *regs); */
  120. int _go32_dpmi_allocate_real_mode_callback_retf(_go32_dpmi_seginfo *info, _go32_dpmi_registers *regs);
  121.     /* points callback at pm_offset, returns seg:ofs of callback addr
  122.        in rm_segment:rm_offset.  Do not change any fields until freed.
  123.        Interface is added to simulate far return */
  124. int _go32_dpmi_allocate_real_mode_callback_iret(_go32_dpmi_seginfo *info, _go32_dpmi_registers *regs);
  125.     /* same, but simulates iret */
  126. int _go32_dpmi_free_real_mode_callback(_go32_dpmi_seginfo *info);
  127.     /* frees callback */
  128.  
  129. /* Only available_memory is guaranteed to be valid.  Try
  130.    available_physical_pages for phys mem left */
  131. int _go32_dpmi_get_free_memory_information(_go32_dpmi_meminfo *info);
  132.  
  133. /* Convenience functions.  These use the above memory info call.
  134.    The return value is *bytes* */
  135. u_long _go32_dpmi_remaining_physical_memory();
  136. u_long _go32_dpmi_remaining_virtual_memory();
  137.